home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / docs / lists / NAM1297.lha / NAM1297 / LON.LHA / LON.readme next >
Text File  |  1996-01-26  |  6KB  |  171 lines
  1.  
  2.                  LON 1.9
  3.  
  4.                      (c) 26-Jan 1996 Jostein Trondal
  5.  
  6.                  Freeware
  7.  
  8.  
  9. Description
  10.  
  11.   Reads either an NComm.log or the NComm.phone-file and gives a list about
  12. when you were last on every system listed in the file (similar to the list
  13. in  Logreader by NHS). The output can be configured different ways. It was
  14. made  mainly because Logreader didn't have a save option for the 'Last on'
  15. function  and  because  it  would  be a helpful tool for supporters of the
  16. NAM-BBS list maintained by Troels Walsted Hansen.
  17.  
  18.   Just recently, I discovered that the log-file Term produces is identical
  19. to  the  NComm-format, thus making this program work with those logs also.
  20. Just write -l<termpath/termlogfile> to make it work.
  21.  
  22.  
  23. Disclamier
  24.                  USE AT OWN RISK
  25.           THE AUTHOR IS NOT RESPONSIBLE FOR ANY
  26.           POSSIBLE DAMAGE THIS PROGRAM MAY CAUSE
  27.  
  28.  
  29. Requirements
  30.  
  31.   - ARexx
  32.   - NComm.log, NComm.phone or a Term log-file.
  33.  
  34.  
  35. Template
  36.  
  37.   <P=Phone|[L=Log|-L<LogFile>]> [-T=ThisMonth] [-O=OnlyDots]
  38.   [U=UpSort|D=DownSort|A=AlphaSort] [-F<OutputFile>]
  39.   [-Wnn=NameWidth] [-N=NoTime]
  40.  
  41.   Parameters in <> are compulsory, and in [] and between |'s optional
  42.  
  43.  
  44. Parameters
  45.  
  46.   P=Phone      Reads  the NComm:NComm.phone file if it exists, and uses
  47.           it  as  basis  for output. To get this parameter to work
  48.           properly,  you  have  to have the 'Log Phone Info' menu-
  49.           selection in NComm active when you call.
  50.  
  51.   L=Log          Reads the NComm:NComm.log file if it exists, and uses ut
  52.           as   basis  for output.  To  get  this parameter to work
  53.           properly,   you  have  to  have  the  'Log Calls'  menu-
  54.           selection in NComm active when you call.
  55.  
  56.   -L<LogFile>      Reads  the  log-file  specified by user. You can specify
  57.           either an NComm-logfile or a Term-logfile. The files are
  58.           of identical type.
  59.  
  60.   -T=ThisMonth      When this options is entered, only systems that has been
  61.           visited in the current month is included in the output.
  62.  
  63.   -O=OnlyDots      When  this option is entered, only systems that contains
  64.           a '.' as the first character in the comment field of the
  65.           phonebook-entry will be included in the output. This way
  66.           you  can  filter  out  the systems you don't want in the
  67.           output.  When  the L option is used, this option will be
  68.           ignored.
  69.  
  70.   U=UpSort      Sorts the output upwards by date.
  71.  
  72.   D=DownSort      Sorts the output downwards by date.
  73.  
  74.   A=AlphaSort      Sorts  the  output alphabetically by system-name. 'The'-
  75.                   substring will be ignored in this mode.
  76.  
  77.   -F<OutPutFile>  Option for file-redirection.
  78.  
  79.   -Wnn=NameWidth  nn = number from 20 to 40; indicates width of the system
  80.                   name in the output.
  81.  
  82.   -N=NoTime       Removes hh:mm:ss from output.
  83.  
  84.   The parameters can be entered in any order.
  85.  
  86.  
  87. Example
  88.  
  89.   To  make  an  alphabetically  sorted list of BBS'es you have visited the
  90. current  month, including only date (not time), and using the NComm-phone-
  91. book as input, write:
  92.  
  93.   Rx lon p -t -n a
  94.  
  95. This should produce an output similar to this:
  96.  
  97.   ABBS Support BBS      25.01.1996  22298897
  98.   Atlantis BBS          13.01.1996  32825330
  99.   Cash'n'Carry          25.01.1996  63909461
  100.   Crusaders MBBS        25.01.1996  22104646|22100893
  101.   Firda BBS             13.01.1996  57865435|57866564
  102.   HiA's BBS             14.01.1996  37253189
  103.   InfoLink BBS          13.01.1996  22571604|22571600
  104.   Mike's BBS            13.01.1996  22416588
  105.   Mordor                22.01.1996  57787379
  106.   Premiere Data Team    23.01.1996  69318244|69318299
  107.   Programmers BBS       13.01.1996  22714107|22714401
  108.   Slektsforum BBS       07.01.1996  35990991
  109.   Ultima Thule          24.01.1996  77613205|77639830
  110.  
  111.   ^System name          ^Date       ^Phone-number(s)
  112.  
  113.  
  114. Bugs
  115.  
  116.   Since the date-calculation of leap years isn't correct in Amigas made by
  117. Commodore,  there  will occur an error when using this program in the year
  118. 2000  on  those  machines  if you not manually change Feb 29th 2000 to Mar
  119. 1st. [:-)]
  120.  
  121.   If you encounter more bugs, please report them to the author.
  122.  
  123.  
  124. History (sigh)
  125.  
  126.   - 1.9  : Fixed Alpha-sort bug; now sorts big/small characters correct.
  127.   - 1.8  : Added -Wnn and -N options and phonenumber in output.
  128.   - 1.7  : Fixed log-file bug. Optimized code.
  129.   - 1.6  : Now ignores 'The'-substring in Alphasort.
  130.   - 1.5  : Fixed many subtle bugs in logreader and phonebookreader.
  131.        Added -L<LogFile> option.
  132.   - 1.4  : Now  reads  a  larger  amount  of Phone.log files that has been
  133.        corrupted by NComm itself.
  134.   - 1.3  : Fixed: If the day of the date was 1..6, it became 2..7
  135.        Changed sorting algorithm (~2.5 times faster)
  136.        Changed sortmode to options
  137.        Didn't bother to include the short-version any longer..
  138.   - 1.2  : Fixed: If a name had more than 21 chars, the program failed
  139.   - 1.1  : Fixed  a  bug that caused the date to be wrong when reading the
  140.        NComm.phone-file
  141.        Some optimization
  142.        Added the s-version in the archive
  143.        Renamed program from LastOn to LON
  144.   - 1.0  : More comments in program
  145.        Improved speed in NComm.phone read (~90% faster)
  146.        Added output-to-file option
  147.        Added only-output-entrys-with-'.'-in-comment-option
  148.        Added only-output-entrys-from-this-month-option
  149.        Better program-structure
  150.   - 0.4ß : Fixed a small sort-bug
  151.        Added 'NComm.phone' read as option
  152.        Added up/downwards-date and alphabetical sort as options
  153.   - 0.3ß : Converted the whole program from Pascal to ARexx
  154.        Some error-checking added
  155.   - 0.2ß : Fixed a bug; When there was only a number in the
  156.        log-file,  and not a system-name and a number, the program lost
  157.        control
  158.   - 0.1ß : First release
  159.  
  160.  
  161. Thanks to
  162.  
  163.   Espen  Verket  and  Troels  Walsted  Hansen for bugreports, comments and
  164. suggestions.
  165.  
  166.  
  167. How to contact the author
  168.  
  169.   - SMail: Jostein Trondal, Klinkeleveien 9, 4815 Saltrød, NORWAY
  170.   - BBS:   Bitflow ABBS +47 37031499 (I'm the SysOp)
  171.